Modification du thème de la documentation Ubuntu-fr

Cette page fait partie du Chantier de refonte du design relancé en 2017 et sert de guide aux administrateurs qui ont pris le parti de repartir de zéro. Une fois en place tous les éléments notés ici feront parti intégrante de l'installation en locale et la page servira ensuite uniquement d'aide-mémoire pour eux.

Il s'agit ici de compléter l'installation de la documentation en locale par la mise en place de son thème et sa personnalisation.

• Installer le plugin bootstrap3 depuis le gestionnaire d'extensions.

$conf['template']    = 'bootstrap3';

• Activer le thème United depuis les paramètres de configuration

$conf['tpl']['bootstrap3']['bootstrapTheme'] = 'bootswatch';
$conf['tpl']['bootstrap3']['bootswatchTheme'] = 'united';

Après enregistrement de ces modifications, actualiser le navigateur: vous devriez être sur le thème United :)

Il est tout à fait possible de partir d'un thème existant pour l'adapter à vos envies.

D'autres navigateurs le font mais Firefox avec ses outils de développement web déjà présent par défaut, permet de récupérer la feuille de style pour l'adapter à vos envies et créer ainsi votre propre thème.

Une fois le thème United en place :

1. ouvrez l'éditeur de style depuis le menu développement web de Firefox accessible directement avec le raccourci clavier Maj + F7.
2. enregistrez le fichier bootstrap.min.css où vous le souhaitez.
   • Pour la suite il sera placé dans un dossier dédié de notre documentation local : lib/tpl/bootstrap3/assets/bootstrap/themeperso1/
3. modifiez le fichier bootstrap.min.css à votre convenance.

Pour activer votre thème il faudra :

• Modifier dans le fichier lib/tpl/bootstrap3/conf/metadata.php la ligne suivante

  $meta['bootswatchTheme']     = array('multichoice', '_choices' => array( 'darkly', 'united', 'themeperso1'));

  C'est d'ailleurs cette même ligne qui défini la liste des thèmes que vous rendez disponible.

Ensuite depuis les paramètres de configuration :

• activer le menu pour les thèmes de bootswatch.com

$conf['tpl']['bootstrap3']['showThemeSwitcher'] = 1;

• activer le répertoire local de Bootswatch

$conf['useLocalBootswatch']          = 1;

Actualiser la page du navigateur. Vous devriez avoir une icône supplémentaire vous permettant de choisir votre thème.

Installer le Plugin Bootswrapper

$conf['loadBootstrap'] = 1;

php -m | grep -i simplexml

SimpleXML

Activer le module navbar en modifiant dans lib/tpl/bootstrap3/conf/default.php la ligne suivante

$conf['useLegacyNavbar']             = 1;

<nav type="tabs">
  * [[:start]]
  * [[:wiki:plugin:bootswrapper:nav|Nav Plugin]]
  * [[playground:playground]]
  * DokuWiki
    * [[:wiki:welcome]]
    * [[:wiki:syntax]]
</nav>

Pour mettre en place le logo et le favicon

voir si c'est utile ou pas de noter ça:

Option sur bootswatch

• open in jsfiddle : Permet de
• bootstrap.min.css : semble être la version non indenté de bootstrap.css
• bootstrap.css : le fichier de feuilles de style
• _variable.scss :
• _bootswatch.scss :

Chantier du design chez aldian